home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / doc / unattended-upgrades / README < prev   
Encoding:
Text File  |  2009-03-02  |  3.5 KB  |  103 lines
  1. Unattended upgrades
  2. -------------------
  3.  
  4. This script can install security upgrades automatically and
  5. unattended. It will not install packages that require dependencies
  6. that can't be fetched from security and it will check for conffile
  7. prompts before the install and holds back the package that creates
  8. them. 
  9.  
  10. == Setup ==
  11.  
  12. The unattended-upgrades package will *not* act unless it is enabled
  13. explicitly.  To activate this script you need to ensure that the apt
  14. configuration contains the following lines:
  15.  
  16. APT::Periodic::Update-Package-Lists "1";
  17. APT::Periodic::Unattended-Upgrade "1";
  18.  
  19. This means that it will check for upates every day and install them
  20. (if that is possible). If you have update-notifier installed, it will
  21. setup /etc/apt/apt.conf.d/10periodic. Just edit this file then to fit
  22. your needs. If you do not have this file, just create it or
  23. create/edit /etc/apt/apt.conf - you can check your configuration by
  24. running "apt-config dump".
  25.  
  26. == Options ==
  27.  
  28. By default it will only install from the the (Ubuntu, jaunty-security)
  29. repository. This can be changed with the
  30. "Unattended-Upgrade::Allowed-Origins" apt configuration list.  It can
  31. be configured to allow any (origin, archive) combination. Those values
  32. are taken from the "Release" file on the archive server, e.g.
  33. http://security.ubuntu.com/ubuntu/dists/hardy/Release
  34.  
  35. The value of "origin" is taken from the "Origin:" header in the file, 
  36. the value of "archive" is taken from the "Suite:" header.
  37. It is recommended to use the default (only security updates from Ubuntu).
  38.  
  39. All operations will be logged in /var/log/unattended-upgrades/. This
  40. includes the dpkg output as well.
  41.  
  42. See https://wiki.ubuntu.com/AutomaticUpdates for more details about
  43. this feature.
  44.  
  45. The following configuration options are supported via the standard 
  46. apt configuration: 
  47. "APT::UnattendedUpgrades::LogDir"
  48. "APT::UnattendedUpgrades::LogFile"
  49. "Unattended-Upgrade::Allowed-Origins"
  50. "Unattended-Upgrade::Package-Blacklist"
  51. "Unattended-Upgrade::Mail"
  52.  
  53. See https://wiki.ubuntu.com/AutomaticUpdates for more details about
  54. this feature.
  55.  
  56. If you use the mail feature, make sure that /usr/bin/mail is available
  57. and working (usually the mailx package is required).
  58.  
  59. == Debugging ==
  60.  
  61. If something goes wrong or if you want to report a bug about the way
  62. the script works its a good idea to run:
  63. $ sudo o unattended-upgrade --debug
  64.  
  65. and look at the resulting logfile in:
  66. /var/log/unattended-upgrades/unattended-upgrades.log 
  67. then. It will contain additional debug information.
  68.  
  69. == Config example ==
  70.  
  71. A example configuration that will install from the
  72. jaunty-security and jaunty-updates repositories daily:
  73.  
  74. ------------------------------8<--------------------------------------
  75. // Automaticall upgrade packages from these (origin, archive) pairs
  76. Unattended-Upgrade::Allowed-Origins {
  77.     "Ubuntu jaunty-security";
  78.     "Ubuntu jaunty-updates";
  79. };
  80.  
  81. // List of packages to not update
  82. Unattended-Upgrade::Package-Blacklist {
  83. //    "vim";
  84.     "libc6";
  85.     "libc6-dev";
  86.     "libc6-i686";
  87. };
  88.  
  89. // Send email to this address for problems or packages upgrades
  90. // If empty or unset then no email is sent
  91. //Unattended-Upgrade::Mail "root@localhost";
  92.  
  93. // These APT::Periodic settings mean that each day the /etc/cron.daily/apt 
  94. // cron job will the update package list, download packages and then run 
  95. // unattended-grade to install them. 
  96. // Lock/Stamp files are in /var/lib/apt/periodic/
  97. APT::Periodic::Update-Package-Lists "1";
  98. APT::Periodic::Download-Upgradeable-Packages "1";
  99. APT::Periodic::Unattended-Upgrade "1";
  100.  
  101. ------------------------------8<--------------------------------------
  102.  
  103.